<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
 <meta>
  <!-- Stylesheets -->
  <link href="../web.css" type="text/css" rel="stylesheet"></link>
  <link href="../pygmentize.css" type="text/css" rel="stylesheet"></link>
  <title>VLFeat - Documentation - Man pages - mser</title>
  

  <!-- Scripts-->
  
 </meta>

 <!-- Body Start -->
 <body>
  <div id="header">
   <!-- Google CSE Search Box Begins -->
   <form action="http://www.vlfeat.org/search.html" method="get" id="cse-search-box" enctype="application/x-www-form-urlencoded">
    <div>
     <input type="hidden" name="cx" value="003215582122030917471:oq23albfeam"></input>
     <input type="hidden" name="cof" value="FORID:11"></input>
     <input type="hidden" name="ie" value="UTF-8"></input>
     <input type="text" name="q" size="31"></input>
     <input type="submit" name="sa" value="Search"></input>
    </div>
   </form>
   <script src="http://www.google.com/coop/cse/brand?form=cse-search-box&amp;lang=en" xml:space="preserve" type="text/javascript"></script>
   <!-- Google CSE Search Box Ends -->
   <h1><a shape="rect" href="../index.html" class="plain"><span id="vlfeat">VLFeat</span><span id="dotorg">.org</span></a></h1>
  </div>
  <div id="headbanner">
   Documentation - Man pages - mser
  </div>
  <div id="pagebody">
   <div id="sidebar"> <!-- Navigation Start -->
    <ul>
<li><a href="../index.html">Home</a>
</li>
<li><a href="../download.html">Download</a>
</li>
<li><a href="../doc.html">Documentation</a>
<ul>
<li><a href="../mdoc/mdoc.html">Matlab API</a>
</li>
<li><a href="../api/index.html">C API</a>
</li>
<li><a href="man.html">Man pages</a>
<ul>
<li><a href="mser.html" class='active' >mser</a>
</li>
<li><a href="sift.html">sift</a>
</li>
<li><a href="vlfeat.html">vlfeat</a>
</li>
</ul></li>
</ul></li>
<li><a href="../overview/tut.html">Tutorials</a>
</li>
<li><a href="../applications/apps.html">Applications</a>
</li>
</ul>

   </div> <!-- sidebar -->
   <div id="content">
    

<h1 align="center">MSER</h1>
<a shape="rect" href="#NAME">NAME</a><br clear="none"/>
<a shape="rect" href="#SYNOPSIS">SYNOPSIS</a><br clear="none"/>
<a shape="rect" href="#OPTIONS">OPTIONS</a><br clear="none"/>
<a shape="rect" href="#DESCRIPTION">DESCRIPTION</a><br clear="none"/>
<a shape="rect" href="#EXAMPLES">EXAMPLES</a><br clear="none"/>
<a shape="rect" href="#SEE%20ALSO">SEE ALSO</a><br clear="none"/>
<hr></hr>
<h2>NAME <a shape="rect" name="NAME" id="NAME"></a></h2>
<p style="margin-left:11%; margin-top: 1em">mser &minus; Maximally
Stable Extremal Regions</p>
<h2>SYNOPSIS <a shape="rect" name="SYNOPSIS" id="SYNOPSIS"></a></h2>
<p style="margin-left:11%; margin-top: 1em"><b>mser</b>
[<i>options</i>] FILE ...</p>
<h2>OPTIONS <a shape="rect" name="OPTIONS" id="OPTIONS"></a></h2>
<p style="margin-left:11%; margin-top: 1em"><b>&minus;v</b>,
<b>&minus;&minus;verbose</b></p>
<p style="margin-left:22%;">Increase verbosity level (may be
repeated).</p>
<p style="margin-left:11%;"><b>&minus;h</b>,
<b>&minus;&minus;help</b></p>
<p style="margin-left:22%;">Show options and version.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;seeds</b>[=<i>FILESPEC</i>]</p>
<p style="margin-left:22%;">Enable/specify seeds output.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;frames</b>[=<i>FILESPEC</i>]</p>
<p style="margin-left:22%;">Enable/specify frames output.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;meta</b>[=<i>FILESPEC</i>]</p>
<p style="margin-left:22%;">Enable/specify meta output.</p>
<p style="margin-left:11%;"><b>&minus;d</b> <i>REAL</i>,
<b>&minus;&minus;delta</b><i>=REAL</i></p>
<p style="margin-left:22%;">Specify delta parameter.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;min-area</b>=<i>REAL</i></p>
<p style="margin-left:22%;">Specify minimum region area.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;max-area</b>=<i>REAL</i></p>
<p style="margin-left:22%;">Specify maximum region area.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;max-variation</b>=<i>REAL</i></p>
<p style="margin-left:22%;">Specify maximum region variation.</p>
<p style="margin-left:11%;">
<b>&minus;&minus;min-diversity</b>=<i>REAL</i></p>
<p style="margin-left:22%;">Specify minimum region diversity.</p>
<h2>DESCRIPTION <a shape="rect" name="DESCRIPTION" id="DESCRIPTION"></a></h2>
<p style="margin-left:11%; margin-top: 1em"><b>mser</b> computes
the <i>Maximally Stable Extremal Regions (MSER)</i> <b>mser</b>
reads an image file (in PGM format), computes the MSERs, and writes
them to a file of region seeds. Alternatively, the <b>--frames</b>
option can be used to compute elliptical frames instead of region
seeds. It is also possible to use <b>--frames</b> and
<b>--seeds</b> in combination to save both seeds and frames.</p>
<p style="margin-left:11%; margin-top: 1em">A
<i>region&nbsp;seed</i> is and index pointing to one of the image
pixels (pixels are enumerated in row major order, with 0
corresponding to the upper-left corner of the image). An MSER
containing a given seed is the largest connect subset of pixels
whose value is not smaller than the seed value.</p>
<p style="margin-left:11%; margin-top: 1em">A <i>frame</i> is an
ellipse approximating an MSER and is specified by 5 floating point
numbers: coordinate of the center <i>x</i> and <i>y,</i> and
elements <i>S11</i>, <i>S12</i>, <i>S22</i> of the co-variance
matrix.</p>
<p style="margin-left:11%; margin-top: 1em">Both seeds and frames
can be saved either in ascii or binary format, based on the
specified <i>FILESPEC</i>s (see also <b>vlfeat</b>(7)):<br clear="none"/>
Ascii format</p>
<p style="margin-left:22%;">Each seed is a decimal number, one per
line of text, and each frame is a list of 6 floating point numbers,
one per line of text.</p>
<p style="margin-left:11%;">Binary format</p>
<p style="margin-left:22%;">The binary format is similar to the
ascii format, except that each seed is stored as a unsigned integer
(four bytes) and each frame component is stored as an IEEE double
(eight bytes). The data is written in little endian order.</p>
<p style="margin-left:11%; margin-top: 1em"><b>mser</b> can process
multiple images. In this case the names of the corresponding output
files are calculated based on <i>FILESPEC</i>s.</p>
<h2>EXAMPLES <a shape="rect" name="EXAMPLES" id="EXAMPLES"></a></h2>
<p style="margin-left:11%; margin-top: 1em">mser test.pgm -d 5</p>
<p style="margin-left:22%;">Computes the MSERs of image
<i>test.pgm</i> setting the parameter <i>delta</i> to 5 and save
the result as a sequence of region seeds to <i>test.mser</i>.</p>
<p style="margin-left:11%;">mser test.pgm &minus;&minus;frames</p>
<p style="margin-left:22%;">Computes the MSERs of image
<i>test.pgm</i>, fits elliptical frames to them and saves the
frames to <i>test.frame</i>.</p>
<p style="margin-left:11%;">mser test.pgm
&minus;&minus;frames=bin:///tmp/%.frame &minus;&minus;seeds</p>
<p style="margin-left:22%;">Computes the MSERs of image
<i>test.pgm</i>, fits elliptical frames to them and saves the
frames to <i>/tmp/test.frame</i> and the region seeds to
<i>test.mser</i>.</p>
<h2>SEE ALSO <a shape="rect" name="SEE ALSO"></a></h2>
<p style="margin-left:11%; margin-top: 1em"><b>vlfeat</b>(7)</p>
<p style="margin-left:11%; margin-top: 1em">J. Matas, O. Chum, M.
Urban, and T. Pajdla. Robust wide baseline stereo from maximally
stable extremal regions. In <i>Proc. BMVC</i>, 2002.</p>
<hr></hr>


   </div>
   <div class="clear">&nbsp;</div>
  </div> <!-- pagebody -->
  <div id="footer">
   &copy; 2007-12 Andrea Vedaldi and Brian Fulkerson
  </div> <!-- footer -->

  <!-- Google Analytics Begins -->
  <script xml:space="preserve" type="text/javascript">
   //<![CDATA[
    var localre = /vlfeat.org/;
    if(document.location.host.search(localre) != -1)
    {
   var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
   document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
   }
   //]]>
  </script>
  <script xml:space="preserve" type="text/javascript">
    //<![CDATA[
    var localre = /vlfeat.org/;
    if(document.location.host.search(localre) != -1)
    {

   try {
   var pageTracker = _gat._getTracker("UA-4936091-2");
   pageTracker._trackPageview();
   } catch(err) {}

   }
   //]]>
  </script>
  <!-- Google Analytics Ends -->
 </body>
</html>

 